CD ROM Paradise Collection 4

home *** CD-ROM | disk | FTP | other *** search

/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / dskutil / diskl310.zip / DISKLIST.DOC < prev next >

Wrap

Text File | 1995-01-05 | 109KB | 2,490 lines

D I S K L I S T Prints a Directory Listing on any Printer DISKLIST is a commercial program and is copyrighted. It is distributed using the Shareware marketing concept. The Shareware concept allows you to try the fully functional program on your computer before you buy it. If you continue to use DISKLIST or keep it for when you might use it, then you MUST send the registration fee to the author. Press F to print the registration form from the program. When you register DISKLIST you will receive: Telephone and mail support. A copy of the latest version of DISKLIST Removal of the Registration Screen & reminders. Skip the Help screen at the start of the program. Skip the Registration Form reminder at the end of the program. A loan amortization program with both the BASIC source code and the compiled program. No registration is required for the amortization program. A copy of SHERLOCK for you to try before registering. A free introductory membership certificate to CompuServe with a $15.00 credit towards online time. _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER Table of Contents ----------------- OVERVIEW.............................. 1 FAST START............................ 2 OPERATION..............................2 PARAMETERS............................ 3 COMMANDS.............................. 5 CONFIGURATION MENU.................... 7 NONLASER PRINTER CONTROL CODES (F5)... 8 EDIT LASER COMMANDS (F6)............. 10 SELECT FORM/PRINTER SIZES (F7)....... 14 DOWNLOAD A LASER FONT (F3)........... 16 POSITION AVERY LABELS................ 17 LAST DRIVE FOR LAN USE............... 18 ADJUST LIST LAYOUT (F4).............. 19 EDIT MULTIPLE FILESPECS (F2)......... 20 CHANGE SHADE DENSITY................. 22 CUSTOM MULTIPLE LIST LAYOUT (F8)..... 23 DISK CATALOG......................... 26 SUBDIRECTORY LIST.................... 27 INK JET PRINTER...................... 27 AVERY LASER LABELS................... 28 PRINT ON DISK SLEEVES................ 30 MULTIPLE LINES OF TEXT............... 30 PAGE TAB VALUE....................... 31 TEXT INPUT........................... 31 STATUS MESSAGES...................... 31 MONOCHROME MONITOR................... 32 SUMMARY OF NON-DISPLAYED COMMANDS.... 32 BATCH OPERATION...................... 32 FILENAMES............................ 34 DISKFLAP............................. 35 INSTALL THE DISKLIST ICON............ 36 SHAREWARE............................ 37 MULTICOPY FEES....................... 38 EPILOGUE............................. 38 COMMERCIAL LABELS.................... 39 OMBUDSMAN............................ 39 IBM GRAPHICS EXAMPLE................. 41 All DISKLIST Software and Documentation Copyright 1991..1994 John P. Bauernschub, Jr. Gulf Sierra 14809 Clavel Street Rockville, MD 20853 301-460-0354 CompuServe ID 73270,77 Internet Address 73270.77@compuserve.com OVERVIEW DISKLIST is designed to print the list of file names from any disk or directory, including subdirectories, onto a stick on label, a sheet of paper that can be cut to the size of the diskette, a 5.25 inch disk sleeve, an 8.5 x 11 sheet, the screen, or a disk file. The list can be in a format that is the size of the floppy so that it can be attached to the floppy, or, if on paper, trimmed to fit into the floppy sleeve. DISKLIST lists the contents of all of the subdirectories on the disk or it can list just the files from a selected subdirectory. DISKLIST provides an easy method to configure the list. Here is an example of one form of a list from DISKLIST. -------------------------------------------------- | GREAT SHAREWARE | | Volume ID is DISKLIST | | 1,457,664 Total Space 893,440 Bytes Free | |------------------------------------------------| | A:\ 153,664 BYTES | | DISKLIST.DOC 34,377 08/15/90 19:32:16 | | DISKLIST.EXE 119,144 08/14/90 22:02:18 | | DISKLIST.PRM 124 03/25/90 11:11:48 | | DISKLIST.TTL 19 03/25/90 11:05:06 | | | | A:\PC-ACCOU.NT 230,862 BYTES | | PCACT220.EXE 156,150 11/08/89 19:03:52 | | PCACT220.TXT 6,838 11/09/89 18:30:42 | | PCDOC220.EXE 67,874 11/08/89 19:09:22 | | | | A:\SHERLOCK 175,967 BYTES | | SHERLOCK.DOC 30,895 08/15/90 19:35:14 | | SHERLOCK.EXE 145,072 08/15/90 19:44:04 | |------------------------------------------------| | 9 Files 08-17-1990 18:46:00 | | | | | | | | | | | | | | | | Created by DISKLIST | -------------------------------------------------- This example is in the "5.25 inch one column with all file data" format for that size diskette. DISKLIST can also print in the 3.5 inch format for the 3.5 inch diskettes, or in the 8.5 x 11 inch page format. There are 39 formats for you to chose from, all easily selectable from the DISKLIST control window. They contain from 1 to 6 columns of filenames. The table of all format names is given in the section "Select Form/Printer Sizes." -1- ASCII lines were selected for the frame of the above illustration so that it would print properly on all printers. If your printer can print the IBM graphics characters (lines, boxes, etc.) then select IBM (unbroken) lines for your list and the frame will be smooth single or double lines. Such an example is given on the last page of this manual. You can also select a format without any lines. Many of the formats do not have any border lines to save space so that you can print on stick on labels. They are identified with Label, Lab, or Page in the Format Size. Labels also leave off the 'Created by DISKLIST'. FAST START To run DISKLIST, just enter DISKLIST at the DOS prompt. Read the Shareware screen carefully, then press RETURN. The control window and Help window are displayed. Read the Help window for instructions on how to navigate the DISKLIST control window. Press any key to close the Help window, it's available anytime by pressing H. If you are using a monochrome monitor, press M to toggle on or off an arrow to indicate the selected parameter. Setup the parameters as you want them, then press P to print a list. When registered (i.e. when you pay the author for DISKLIST), you will receive a program that will skip the Shareware screen and the help window and be immediately ready for business. After you have used DISKLIST, enter the F command to print the registration form, fill it out and send it with the registration fee to the program author. Thanks. When DISKLIST starts, it is ready to print the directory on the drive it used last. This is easily changed from the DISKLIST control window in the program by selecting the first parameter and pressing the right or left arrow keys. You can also select the source directory drive from the DOS command by entering the drive letter (colon not necessary but accepted). For example, if you were going to print the directory of drive A: and the last drive DISKLIST used was B:, then the command would be: DISKLIST a OPERATION When DISKLIST starts, it reads several data files. These files must be in the same directory as DISKLIST.EXE. If your operating system is DOS 3.3 or above, you can run DISKLIST from any -2- directory and it will find its data files. For older versions of DOS, make the directory DISKLIST.EXE is in the default before running it. To run DISKLIST, just enter DISKLIST at the DOS prompt. After the Shareware screen, the DISKLIST control window will appear. Parameters D I S K L I S T Commands ═══════════════════════════════════════════════════════════════════ 1 - Disk Drive A: H or F1 - HELP A - Shade Yes 2 - Filespec *.* P - Print List Z - ZIP No 3 - Sort Files by Name Ascending L - Line Feed E - Eject Page 4 - Directory \ B - Subdirs Yes T - LPT1: 5 - Output Device NonLaser Printer S - Save Title on Disk Drive 6 - Format 3.5 1 with All R - Read Title from Disk Drive 7 - Border Line Type ASCII |---| F - Print Registration Form 8 - Lines Per List 28 C - Configuration 9 - Title for List F10 or ESC - Quit DISKLIST The List Title is Displayed Here Illustration of the Control Window Press Function Key 1 or H to display the help window. It explains how to navigate the control window. The words Parameters and Commands in the top line of the control window can be toggled on and off with the command Control H. Parameters and Commands are the first level of control of DISKLIST. They consist of the items that you may want to change quickly and frequently. There are many other menus for affecting you desired application of DISKLIST. DISKLIST lets you configure your directory lists to your requirements. The configuration is saved when you exit DISKLIST and will be automatically read the next time DISKLIST is run. PARAMETERS Select a parameter from the first list of items in the control window by entering the sequence number of the parameter, or move the highlight with the up and down arrow keys. Change the parameter by scrolling through the allowable values with the left and right arrow keys or the space bar. If you are using a monochrome monitor, press M to toggle on an arrow to indicate the selected parameter. When parameters 2, 4, 8 or 9 are selected, a window will open for text entry. Press ESC to delete the previous entry, or edit it with the standard editing functions. Insert also works. When -3- the entry is complete, press the up or down arrow key or RETURN. The input window will disappear. If you completed the entry with a RETURN, the highlight will stay on the parameter. Use the left or right arrow key to reopen the window. The parameters permit you to: Select any disk drive - floppy, hard, ram disk, or CD ROM. Provide a file selection specification, Filespec. Sort files by name, date, extension, size, or no sort. Sort direction - ascending or descending. Select a starting directory or sub-directory Select as an Output Device: Laser Printer, NonLaser Printer, Ink Jet Printer, Your Computer Screen, an Avery Laser Label, a Disk Sleeve on a LJ 3 or LJ 4, Write to a Disk File, or Create a Catalog File. Select a format from the 39 formats available Select a border line type for other than label and page formats - None, ASCII dashes, IBM single or double lines. Change the number of lines to be printed on the list. Enter a title for the list. DISKLIST supports nonlaser (dot matrix and daisy wheel), laser, and ink jet printers. The difference has to do with which set of control codes DISKLIST sends to the printer. The control codes for nonlaser printers are saved with the general setup parameters in the file DISKLIST.PRM and the laser printer commands are saved in DISKLIST.LSR. These will each be discussed separately. DISKLIST considers ink jet printers the same as laser printers in most cases and always uses laser printer commands for them. As you move through the Format selections with the right and left arrows, the Lines Per List data will change to reflect the value for that size parameter. When the Lines Per List parameter is selected, a window pops up for entry of the new value. The original value that came with DISKLIST is in parens for reference. When DISKLIST prints a list with a border that is physically longer than the diskette, either 5.25 or 3.5 inches, it will put marks on the border indicating where to fold the paper to neatly match the disk size if a border is being printed. In the ASCII border line type there is a - instead of the |. In the IBM border line type the horizontal tick mark is part of the vertical line and is harder to notice, but it is there. The line this -4- prints on is determined by the value for Lines Per List. If you wish to print a shorter framed list when you have fewer rows of file names, set the Lines per List to a lower value with parameter 8. The border line type selection does not apply when any page format, label format, or Output Device File or Disk and Vol Name is selected. There are no borders on the Page, Label or File outputs. When a format for one of these is selected, Border Line Type displays 'Not with above Fmt'. Actually the word 'above' is an upward pointing arrow on the screen. When the Screen, File, or Disk and Vol Name is selected as the output device, none of the compressed or multiple column modes are available. The Page formats are ideal for producing a list of all files on a hard drive and saving the list in a loose-leaf notebook. For the nonlaser printer, when a mode that uses compressed print is selected, DISKLIST combines the codes for compressed on and 8 lines per inch (in that order) and prints a line with those codes. This will not print anything but will cause the printer to advance one line. Likewise, on completion of the list printing, another line with the codes for compressed off and 6 lines per inch will be printed. These two blank lines are included in the number of lines per list for the nonlaser printer. So, you can put any codes in these parameters. There is no limit to the number of codes you may use. When a format that doesn't use a compressed font is selected, no codes are sent to the printer. For laser and ink jet printers, the laser commands are always sent. There is a set of laser commands for each format. COMMANDS The commands are in the second column of the control window. Most commands produce an action as soon as the command key is pressed. Some toggle frequently used features Yes (on) and No (off). P is the most important command because it starts the production of the list. G for Go will also work. A toggles the printing of shade by laser printers on and off. B controls reading subdirectories. If it is set to No it will only read the directory selected in parameter 4, otherwise it will read the directory selected in parameter 4 and all the subdirectories below it. -5- F will print the registration form. C activates the Configuration menu. DISKLIST has many other configuration items that give you great flexibility in defining the appearance of the list. There is a separate section in the manual on the Configuration menu. S will save the list title that is displayed below parameter 9 in a file named DISKLIST.TTL on the drive selected in parameter 1. R will retrieve the title from the selected drive and display it below parameter 9. You will see later how to have DISKLIST automatically do this when it generates a list. E (Eject Page) sends a form feed to the printer. L (Line Feed) sends a carriage return to the printer. CTRL R or CTRL E send the laser printer Reset command, ESC E, to the printer to eject a page (it is not listed on the control window). When these commands are sent, DISKLIST acknowledges by beeping. If the beep is annoying, press CTRL B to turn the beep off. Another CTRL B will turn the beep on. T directs the printer output to LPT1, LPT2, or LPT3 - make sure you have the right one selected. Remember to change the Output Device if one printer is a laser and the other is not. Switching printer ports may not work if you are using a print spooler. It does work with the spooler DMP. If you have a serial printer, you must have set it up with the DOS MODE command before starting DISKLIST. Z signifies the status of DISKLIST reading the file directory in ZIP, ARC, PAK, ZOO, and LZH files. These file names are displayed in lower case letters to signify that they are from an archive. These file names are not sorted. F10 or ESC terminate DISKLIST. The current settings for all parameters, commands, configuration, etc. are saved. Only the laser commands are not saved here, but they can be saved from the Edit Laser Commands window. D writes the parameter save file, DISKLIST.PRM. DISKLIST does this automatically when you exit. It is there as a development tool to aid restarting when the version under development ends prematurely. See the section titled SUMMARY OF NON-DISPLAYED COMMANDS for more commands. -6- CONFIGURATION MENU The C command pops up the Configuration menu. CONFIGURATION ══════════════════════════════════ 1 - NonLaser Printer Codes F5 2 - Edit Laser Commands F6 3 - Select Form/Printer Sizes F7 4 - Display Quit Warning Yes 5 - Download a Laser Font F3 6 - Lines to skip at label gap 0 7 - Position Avery Labels 8 - Last Drive for LAN use K: 9 - Adjust List Layout F4 A - Edit Multiple Filespecs F2 B - STOP at Avery label bottom Yes C - Change Shade Density D - Custom Multiple List Layout F8 E - Suppress Extra Page Eject No L - Laser Printer Language PCL5 Select [Quit]? Those items that have a function key number in the right column can be activated directly from the control window by pressing that key. 4 - Display Quit Warning. When you exit DISKLIST a prompt asks if you really want to quit. That prompt can be toggled on and off here. 6 - Lines to skip at label gap, will cause a nonlaser printer to skip lines between labels when printing a list that is longer than one label. This is intended to be used when printing on gummed mailing labels that will be stuck to a disk. Set Lines Per List, item 8 on the control window, to the number of lines from the beginning of one label to the beginning of the next label. Then enter the number of lines to be left blank. If Lines Per List = 10 and Lines to skip at label gap = 3, then DISKLIST will print 7 lines then skip 3, then repeat. B - STOP at Avery Label Bottom. Toggle item B Yes, Ask, and No, by pressing B. This feature tells DISKLIST what to do when printing on an Avery label and comes to the end of the label as defined by parameter 8, Lines Per List. Yes means always stop printing. Ask means stop and ask if you want to stop, and of course, No means keep on printing as it does now. E - Suppress Extra Page Eject. Some laser printers will eject a blank page when it receives the reset command, ESC E. DISKLIST -7- sends ESC E commands to reset the printer. The Laser Jet 3 is smart enough to not eject a blank page, but the Laser Jet 2 is not. This item is in the Configuration menu to suppress the extra page ejects. The default is no, but if this is a problem with your printer, select Yes. L - Laser Printer Language toggles between PCL4 and PCL5. PCL means Hewlett Packard Printer Control Language. The number is the version number. PCL4 is on HP Laser Jet 2 printers. PCL5 is on HP Laser Jet 3 and later Laser Jet printers. DISKLIST is developed on an HP Laser Jet 3 and now generates some laser commands that are not on printers that only have PCL4. Many clone laser printers emulate PCL4 so some DISKLIST functions don't work on those printers. So that is why you have a choice. The default is PCL5. From DISKLIST, press C for Configuration then L to toggle between PCL5 and PCL4. Output Device selections Avery-Laser and Multiple Laser now work on PCL4 printers when PCL4 is selected. WHAT DOESN'T WORK on printers that do not emulate PCL5, i.e. the HP Laser Jet 2? SHADE on output device selections Avery-Laser and Multiple Laser works on the left most column of lists. If you try to print a list in list columns 2 or 3, the list will print in the proper position, but the shade will print in column 1. The remaining items in the configuration menu will each be discussed in a separate section. NONLASER PRINTER CONTROL CODES (F5) (Laser printers users skip 2 pages to EDIT LASER COMMANDS) DISKLIST has a generic set of nonlaser (dot matrix) printer control codes. It only uses the codes to switch to and from compressed (17 characters per inch) and regular (10 characters per inch), and between 6 and 8 lines per inch for the compressed printer modes. The default generic printer control codes work on many printers and have been tested on the Epson FX-86e and IBM Proprinter II. DISKLIST provides a nonlaser printer code editor. It is activated with the C command or directly with F5. Use it to install your printer control codes for these functions if the default codes do not work with your printer. It is easy to do this with information supplied in your printer manual. These printer control codes will be saved in the same file with the other DISKLIST parameters when you exit DISKLIST. -8- When you enter the editor to change the printer codes, this window will pop up. The figure illustrates an example when key 1 was pressed to change the codes for compressed on. NONLASER PRINTER CODES ====================================== 1 - Compressed ON 15 2 - 8 Lines per Inch 27, 48 3 - Compressed OFF 18 4 - 6 Lines per Inch 27, 50 ====================================== 1 to 4 - Enter the Decimal Codes D - Restore the Default Codes R - Restore Before Entry Codes C - Clear All Codes F10 - Quit and Use these Codes ====================================== Enter the codes for Compressed ON ? 15,7,65 Printer manuals contain a section or appendix on printer commands, software commands, or control codes. These codes are sent from the computer to the printer by DISKLIST to change the character size and line spacing. If DISKLIST doesn't print the directory list in a conventional format, use the nonlaser printer code editor to tell DISKLIST what codes to send to your printer to make it print correctly. Your printer manual may have the codes in three different formats, ASCII, decimal, and hexadecimal. Only enter decimal codes into DISKLIST. These are all numbers between the values of 0 to 127. There are usually 1 to 3 numbers for each function being changed. Enter all of the numbers for one function on one line and separate the numbers with a space or comma. There is no program limit to the number of control codes you may enter. The above figure of the codes window illustrates how a new code is being entered for the function Compressed On. To delete the line of codes on the prompt line, press the ESC key. DISKLIST will only accept numbers from 0 to 255. It will ignore all other numbers and beep as it does. It will accept any quantity of numbers for each function but will only display those that fit in the window. DISKLIST only transmits these codes to the printer when a compressed mode is selected. See the table that defines the print formats on or near page 7. -9- When data on the prompt line exceeds the width of the window, then the prompt line scrolls horizontally. You can then scroll the data horizontally with the cursor keys; the display window shows only the numbers that fit in the window. The D command on the Printer Codes window will restore the built in codes that came with DISKLIST. If you want to print the IBM graphic lines on a DISKLIST listing, then you must select the IBM mode on your printer. Try printing a directory list with the IBM lines selected in DISKLIST with the Border Line Type parameter. If it does not print the IBM lines, read your printer manual to locate the switch to flip to activate this mode on your printer. This applies to dot matrix printers only. You can print the title and disk volume name in double strike on dot matrix printers. To activate it, rename the file DISKLIST.C that came with DISKLIST to DISKLIST.C1. The contents of the sample file DISKLIST.C are: 27,71,-1 27,72,-1 27,71 are the printer codes to select Double Strike on most dot matrix printers. -1 is the terminator of the string of code numbers. 27,72 are the printer codes to remove Double Strike from most dot matrix printers. Again -1 is the terminator of the string of code numbers. If renaming DISKLIST.C to DISKLIST.C1 doesn't work on your dot matrix printer, then create a file named DISKLIST.C1 with the codes for your printer. Put in the decimal values of the codes to select double strike, separated by a comma, and followed by a -1. Do the same on the next line to cancel double strike. If you do not have a laser printer, you may delete the file DISKLIST.LSR so DISKLIST doesn't have to take the time to read it. EDIT LASER COMMANDS (F6) This section describes how to modify the laser commands used by DISKLIST for the Output Device selection Laser Printer. The laser commands used by the other output selections cannot be changed other then by the configuration options of PCL4/PCL5 and suppress extra page ejects discussed earlier in this manual. DISKLIST was developed on a Hewlett Packard Laser Jet III. Imbedded laser commands in DISKLIST that you can not change and -10- those in DISKLIST.LSR use PCL5 printer language commands. Before version 2.60 DISKLIST used only one command that was unique to PCL5. That was to print reverse portrait (upside down) on 5.25 inch disk sleeves. With the introduction of micro adjusting the left margin on Avery labels, DISKLIST uses another unique PCL command for the micro adjusting, ESC &l#U for left (long edge) offset registration replacing ESC &a#L for set left margin. DISKLIST has a set of laser commands in the file DISKLIST.LSR for each format. It also has a laser command editor, accessed with F6, so you can easily change them. The laser commands are setup in the following categories: Symbol Spacing Pitch & Point Size Orientation Top Margin Lines per inch Left Margin, Row Reset You can put any commands on any line. These categories are for reference only. Just remember, when laser printer is selected, DISKLIST concatenates all of the commands in the first 7 categories and sends them to the printer. After the list is printed, DISKLIST sends the commands in the eighth category, Reset. You don't have to have any laser commands, and there is a key (F8) to delete all commands for a format. Or, you can delete the file DISKLIST.LSR and that will clear out all of the commands and DISKLIST will still run. For Output Device selections Avery-Laser and Sleeve on LJ 3 and LJ 4, the laser commands are in the program and cannot be changed. Laser commands are all printable ASCII characters except ESC. The IBM character set displays ESC on the screen as a left pointing arrow. So does DISKLIST. To enter ESC on the command line, just press the ESC key. Now, since the ESC key is used for input, how do you get out of the editor? Press Function Key 10. To be consistent, DISKLIST will quit all functions when F10 is pressed. There is a space after ESC in this manual for clarity. In the actual HP laser command there is no space. In the laser command editor the ESC is displayed as a left arrow with no space. The -11- laser editor has the following functions: F1 - Help F2 - Copy to Pass Buffer F3 - Insert from Pass Buffer F6 - Insert Default Commands Here F7 - Clear Active Command Line F8 - Clear All Commands for this size F9 - Save All Commands for all sizes F10 - EXIT When in the laser editor, you may select another format with F11 & F12, or ALT or Control with the left and right arrows. The file DISKLIST.LSR is an ASCII file. F9 will save changes to this file. It can also be edited with a text word processor like EDIT in DOS since version 5.0. Each format has an ID number. These numbers and the format name are written to the file so you can locate the commands. When DISKLIST reads this file, it uses the ID number to identify the format, but it ignores the name. It only needs the commands for the formats that you want to use, and the formats do not have to be in sequence in this file. The default laser commands include a reset command ESC E with the symbol command ESC (10U. The HP reset command is ESC E. If you want to print more than one list on a page, then remove both of the reset commands (ESC E) because it forces a form feed. You may then force a form feed with E for Eject Page or CTRL R from the control window. CTRL R sends the laser command ESC E to the printer. So does CTRL E, ALT R, & ALT E. If your laser printer always ejects a blank page when using DISKLIST, as HP Laser Jet 2 printers do, then remove the first ESC E. The top margin command is ESC &l#E. That is a lowercase L before the # sign and not the number one. Replace the # with the line number of the top line of the label. You may want to change the laser commands that adjust where the label is printed, i.e. the starting left margin and top row. The default commands for these are ESC &l0U ESC &a1R. Again that is a lower case L after the first &. These define the upper left corner of the list. Replace the zero before the U with the number of the column multiplied by 720 to start the list (left margin) and the 1 before the R with the line number (row). Do not put any spaces in the command string. You may want to try replacing the one before the R with a zero to print closer to the top of the page. Some laser printers may cut off the top part of the first line if you print on row zero. -12- You may want to print multiple labels on one sheet. This capability is much easier implemented using the Custom Multiple List Layout (F8), or you can use the following process. First remove the ESC E commands. Press F6 to get into the Laser Command Setup to remove the ESC E. After printing the first list, press F6 to get into the Laser Command Setup again. Move down to Left Margin, Row, and change the HP command of what line to start on. Change the decimal number before the R in the command string from 1 to 30. After printing the second list, press CTRL E to eject the page. Try other numbers to gain experience positioning the list where you want it. You may print starting at row 30 first, then delete the 3 and print to row 0 next. Think of a laser printer as a screen where you can jump around the page and not as a dot matrix printer where you always have to print from top to bottom. 3.5 inch formats can be printed side by side, as is done for Avery labels. F2 and F3 operate a pass buffer. They are used to copy the laser commands one format to another. F2 copies the laser commands from the displayed format to the pass buffer. Select another format, press F3 and the laser commands from the pass buffer are copied to this format. F9 saves all the laser commands to the file DISKLIST.LSR. DISKLIST will not automatically save the laser commands when it quits like it does the configuration - so use F9. F6 will replace all the laser commands for one format with the default laser commands that were originally in DISKLIST.LSR. DISKLIST prints the disk volume name and the title in bold italic. If the font does not have bold italic, the printer will print normal. The command that is sent for bold italic is ESC (s1s7B and to return to normal, ESC (s0s0B. These commands are coded into DISKLIST and can't be changed. If this causes problems with any printer, please let me know and I will fix the problem. If you are only going to use DISKLIST with a laser printer, I suggest that you remove all nonlaser printer codes. See the previous section on Nonlaser Printer Control Codes. Use the C command to clear all codes then exit. Select Laser Printer for item 5 on the Control Window. This will prevent the accidental sending of nonlaser codes to a laser printer. See the file DISKLASR.DOC for additional information on laser commands. -13- SELECT FORM/PRINTER SIZES (F7) DISKLIST provides a large selection of list layouts. Some contain all the file information, name, size, date, and time. Others contain only the name, or the name and date, or the name and size. You may have from one to six columns of file names on a list. Remember, label formats do not print any border lines and they skip to the beginning of the next label based on the value in Lines Per List. They also do not print Created by DISKLIST. The following table lists all of the DISKLIST formats and specifies the features of the format. The type 'Avery' indicates that format will fit on Avery labels. Not all label formats are Avery label format, but an Avery label format is also a regular label format. Format names are displayed in line 6 of the control window. The name is decoded as follows: the first item indicates the size of the list, i.e. 3.5 means it is less than the width of a 3.25 inch diskette, 5.25 means it is less than the width of a 5.25 inch diskette, page signifies the output is sized to fit an 8.5 x 11 inch sheet. The numbers 1 through 6 after size indicate the number of columns of file names across the list. The "with" or "&" indicate the file data listed with the name. 'n Across' means just file names are listed. Lab means it is a label format and has no border. -14- Format Format Sized for Number Name Diskette Columns Info Printed Pitch Type 1 Page 1 with All 8.5 x 11 1 Name Size Date Time Page 2 3.5 1 with All 3.5 1 Name Size Date Time Comp List 3 3.5 1 & All Lab 3.5 1 Name Size Date Time Comp Avery 4 3.5 2 & Size 3.5 2 Name Size Comp List 5 3.5 2 & Size Lab 3.5 2 Name Size Comp Avery 6 3.5 2 & Date 3.5 2 Name Date Comp List 7 3.5 2 & Date Lab 3.5 2 Name Date Comp Avery 8 5.25 1 with All 5.25 1 Name Size Date Time List 9 5.25 1 & All Lab 5.25 1 Name Size Date Time Label 10 5.25 2 with All 5.25 2 Name Size Date Time Comp List 11 5.25 2 & All Lab 5.25 2 Name Size Date Time Comp Label 12 5.25 2 & Size 5.25 2 Name Size List 13 5.25 2 & Size Lab 5.25 2 Name Size ** Avery 14 5.25 2 & Date 5.25 2 Name Date List 15 5.25 2 & Date Lab 5.25 2 Name Date ** Avery 16 5.25 3 & Size 5.25 3 Name Size Comp List 17 5.25 3 & Size Lab 5.25 3 Name Size Comp Avery 18 5.25 3 & Date 5.25 3 Name Date Comp List 19 5.25 3 & Date Lab 5.25 3 Name Date Comp Avery 20 5.25 4 & Size 5.25 4 Name Size Comp List 21 5.25 4 & Size Lab 5.25 4 Name Size Comp Label 22 5.25 4 & Date 5.25 4 Name Date Comp List 23 5.25 4 & Date Lab 5.25 4 Name Date Comp Label 24 3.5 3 Across 3.5 3 Name Comp List 25 3.5 3 Across Lab 3.5 3 Name Comp Avery 26 5.25 3 Across 5.25 3 Name List 27 5.25 3 Across Lab 5.25 3 Name Label 28 5.25 4 Across 5.25 4 Name Comp List 29 5.25 4 Across Lab 5.25 4 Name Comp Avery 30 5.25 5 Across 5.25 5 Name Comp List 31 5.25 5 Across Lab 5.25 5 Name Comp Label 32 5.25 6 Across 5.25 6 Name Comp List 33 5.25 6 Across Lab 5.25 6 Name Comp Label 34 Page 2 with All 8.5 x 11 2 Name Size Date Time Comp Page 35 Page 3 & Date 8.5 x 11 3 Name Date Page 36 Page 4 & Date 8.5 x 11 4 Name Date Comp Page 37 Page 4 Across 8.5 x 11 4 Name Page 38 Page 5 Across 8.5 x 11 5 Name Comp Page 39 Page 6 Across 8.5 x 11 6 Name Comp Page ** The formats '5.25 2 & Size Lab' and '5.25 2 & Date Lab' print compressed when the Output Device is Avery-Laser so they fit on the Avery label. The format to use is selected with item 6, Format, on the control window. There are 39 selections. -15- The display at the bottom of the control window screen displays information from the above table. It explains the selected format in more detail. Columns are the number of groups of data that are printed on a line and Info Printed is the data in each group. This display can be toggled on and off with CTRL L. DISKLIST provides a way for you to quickly select a format. F7 displays the Configuration Format Menu. Move the cursor to the format you want and press F10. That will then be the format selected to use in the command window. You can also use the Configuration Format Menu to create a list of formats that you want available from the control window. If, for example, you only have a 3.5 inch disk drive, then you do not want to scan through all the selections for 5.25 inch drives. A diamond indicates formats selected to be available as options from parameter 6 - Format on the control window. Select or deselect the items you want with the space bar. Use the cursor keys to move around the list. Press F10 when done. This configuration will be saved when you exit DISKLIST. Use a page format to list the files on your hard drive and put the pages in a notebook for reference. DOWNLOAD A LASER FONT (F3) DISKLIST will download your soft fonts for you. Here's how. Create an ASCII file with a text editor or word processor. Name this file DISKLIST.FNT. Insert the DOS file name and a description of the font. Place a comma after the DOS file name. You may enter up to 10 names, each must be on a different line. Example: CO085R16.USP, Courier 8.5 Point 16.6 Pitch RO100R12.UPS, Times Roman 10 Point 12 Pitch Copy your font files and DISKLIST.FNT to the directory with DISKLIST.EXE. Fonts do not come with DISKLIST. The download section is accessed by pressing F3 from the Control window, or selection 5 from the configuration window. DISKLIST will display the file names and fonts and you select the one to download. DISKLIST will download the font and select it. The HP command codes that DISKLIST uses are given in the file DISKLASR.DOC. You may have to change the laser commands, particularly the Lines per inch, to properly utilize this font, or delete them all with F8. You may also want to change the Lines per List, parameter 8 -16- in the Command window. Also remove the two reset commands, ESC E, since either may delete the downloaded font. POSITION AVERY LABELS DISKLIST provides two methods of positioning the location of labels on Avery labels, horizontal and vertical. Each is different and has a separate procedure. On some laser printers the list doesn't quite align horizontally with the left edge of the Avery labels and a character or two may not print on the label. You may adjust the left margin where DISKLIST starts printing the Avery label for each column in increments of plus or minus 1/720 th of an inch. Many users question why DISKLIST prints about an inch down from the top of 3.5 inch labels. That is because that part of the label wraps around the back of the floppy. Now the top and bottom line of the list can be adjusted on Avery labels by line. This provides the benefit of being able to put more file names on a 3.5 label. Select Configuration from the control window. Then select item 7 from the Configuration menu. A window will open titled Adjust Avery Label Position listing these three procedures: 1 - Top Up and Down 2 - Bottom Up and Down 3 - Left and Right Select item 1 from the Adjust Avery Label Position menu to reposition where the top line of the list will print on the Avery Label. Enter values that will reposition the top line of the Avery label from the DISKLIST default position by numbers of lines. This will effect every 3.5 and 5.25 inch label on the sheet. Positive values move the top line down, negative values move the top line up. Select item 2 from the Adjust Avery Label Position menu to reposition where the bottom line of the list will print on the Avery Label. This is only important if you toggle item D on the Configuration menu to YES to stop printing at the end of the Avery label. You will enter data the same way as in adjusting the top line. Select item 3 from the Adjust Avery Label Position menu to micro adjust the left edge of the list. You are prompted to enter values that will reposition the printing of the lists by 720ths of an inch for each column of both 3.5 and 5.25 labels. The values can be positive or negative. Negative values adjusts to the left. -17- An adjustment of the left margin of one label column does not affect the position of the other label columns. Each column is adjusted individually. These values are saved by DISKLIST. When prompted for new values, enter a new value or press RETURN to accept the value in the brackets. For example, DISKLIST prints about 17 characters per inch on most Avery Labels. So to shift the left margin to the right by one character, the value entered would be 42 (= 720/17). You can see that you have very fine control of the position of the left margin. If PCL4 is selected in the configuration menu, then DISKLIST can only adjust the margin by full character widths. However still enter the data in the values for 720 parts per inch and DISKLIST will convert these values when PCL4 is selected. LAST DRIVE FOR LAN USE (This feature is also useful even if you do not access a LAN, so all should read this section). When DISKLIST starts, it checks to determine the last physical drive in your computer and limits your drive selection to this value. DISKLIST does not detect drives on a lan or ram or CD ROM drives. To set the last drive letter in DISKLIST, select Configuration from the control window. Then select item 8 from the Configuration menu. A question mark indicating a prompt appears at the end of the menu line: Last Drive for LAN use? Enter the highest drive letter you expect to use. It doesn't hurt to enter Z. If you try to have DISKLIST read a drive that it can not, it presents an error message. If you have selected a last drive letter and want DISKLIST to return to automatic detection of the last drive, press return at this prompt. This feature can also be used if you only want DISKLIST to select drives A and B. Set the last drive letter to B. This could save you from accidentally printing a list of your hard drive. -18- ADJUST LIST LAYOUT (F4) Selecting item 9 in the configuration menu or pressing F4 in the control window activates the Adjust List Layout menu. This provides a way of customizing the list DISKLIST prints. All of the items toggle Yes/No to tell DISKLIST what to do. Adjust List Layout ═════════════════════════════════ 1 - Print Total Space at TOP Yes 2 - Print Date-Time at TOP No 3 - Print Date-Time at BOTTOM Yes 4 - Line under Title & Label No 5 - A Blank Line at the Top No 6 - Print File Names Yes 7 - Auto Read Title from Disk Yes 8 - Print Root Directory Name Yes 9 - Print Header File No A - Print Volume Name Yes B - Blank Line Before New Dir Yes D - Date Format MM/DD/YY E - List Date Style 01/08/94 Z - Print Created by DISKLIST Yes Select [Quit]? With a little ingenuity you can print many types of lists. You can even inhibit printing file names. You would do that if you just wanted to print a header file, item 9, on the label using DISKLIST. Item 9, Print Header File, is described in the Multiple Lines of Text section. Item Z option is only available in registered versions. D - Date Format. To select another data format, press 4. As you continue to press 4, the 9 date formats will cycle in position until the date format you want to use is displayed. The date formats are: MM/DD/YY DD/MM/YY YY/MM/DD MM-DD-YY DD-MM-YY YY-MM-DD MM.DD.YY DD.MM.YY YY.MM.DD E - List Date Style toggles the selection of the style of the date that can be printed at the top or bottom of the list. One choice is identical to the date format selected for the file date. The other is from the DOS date and is in the format MM-DD-YYYY only. The current date is displayed here in the selected style and format. -19- EDIT MULTIPLE FILESPECS (F2) Filespec selection is item 2 in the control window parameter list. It permits specifying just what files you want to see on the list. The default is *.* which selects all files. For example, you may change it to *.EXE to list only the executable files. It has two functional implementations. The simple implementation lets you set one filespec. When the control window highlight is moved to selection 2, an input window opens with the current filespec available for editing. Press ESC to erase it or edit it in a normal way. This gives you only one filespec. If the filespec is deleted and none supplied, DISKLIST will display the default *.* for parameter 2. The second implementation provides sets of up to 12 filespecs each and is accessed by pressing F2 while in the control window, or from the Configuration Menu. Two terms will be used in the following discussion, 'FILESPEC name' and 'filespec'. FILESPEC name is the name you may give to a group of one to twelve filespecs. Filespecs are any valid DOS search specs in that group, such as *.bat, File00??.*. This will be easier to understand when you run DISKLIST for the first time and switch to the setup of these items by pressing F2 from the control window. The following screen will appear with the word ALL highlighted: _______________________________________________________________________ Multiple Filespec Edit ACTIONS FILESPEC names filespecs * A - Add FILESPEC name ALL *.* B - Delete FILESPEC name DOC FILES C - Add Filespec D - Delete Filespec {in this screen the word 'ALL' above will be highlighted} Select an ACTION by the Letter or FILESPEC name by Up Down arrows ESC or RETURN to Exit Enter = after filespec to skip matching filespecs i.e *.bak= ≡ implies skip matching filespecs * List of Filespecs for the selected FILESPEC name _______________________________________________________________________ -20- Press the down arrow and to move the highlight to DOC FILES. The data in the column under filespecs changes to show the filespecs associated with the FILESPEC name DOC FILES. The top part of the screen will now appear as: _______________________________________________________________________ Multiple Filespec Edit ACTIONS FILESPEC names filespecs * A - Add FILESPEC name ALL *.doc B - Delete FILESPEC name DOC FILES a*.* C - Add Filespec D - Delete Filespec {in this screen the words 'DOC FILES' above will be highlighted} _______________________________________________________________________ DOC FILES is initially provided as an example and can be deleted with the B Action. In this mode you can assign up to 12 filespecs to a FILESPEC name, and you can have 12 FILESPEC names. A FILESPEC name is a group of 1 to 12 filespecs. The FILESPEC names can be anything you wish, up to 14 characters. Spaces can be used but not commas. Commas will be replaced by _. This screen lets you add and delete FILESPEC names and filespecs, and select the FILESPEC name to use. The FILESPEC name that is highlighted is the selected one that DISKLIST uses when you exit this routine. If that FILESPEC name has only one filespec, then that filespec is displayed in parameter 2 in the control window in lower case. If it has more than one filespec, the FILESPEC name is displayed in parameter 2 in uppercase. The list of filespecs is displayed for the highlighted (selected) FILESPEC name. Add another FILESPEC name by selecting Action A, then add some filespecs to it by selecting Action C. Select the first FILESPEC name and watch the list of filespecs change. If you enter a filespec from the window on the control screen, that filespec is displayed in uppercase. If you enter a FILESPEC name from the window on the control screen below the control window, it will not be processed the same as a FILESPEC name and DISKLIST will NOT USE THE filespecs ASSOCIATED with the FILESPEC name. You must use the screen accessed with F2 to select a FILESPEC name. When more than one filespec is entered for a FILESPEC name, DISKLIST will select all files that satisfy any one filespec. The filespecs are ORed for the file name selection. -21- The file select routine does not operate on files inside a .ZIP, .ARC, etc. file. If the option to display the files inside a .ZIP is selected, and if the .ZIP file itself is selected by a filespec, then all the files inside it will be listed. When you create a new FILESPEC name, DISKLIST assigns the filespec *.* to it. Likewise if you delete the one and only filespec for a FILESPEC name, then DISKLIST again assigns the filespec *.* to it. When you add the first filespec, DISKLIST replaces *.* with the new filespec. There must be two filespecs associated with a FILESPEC name for the FILESPEC name to appear in the control window. Again, if you edit or insert the FILESPEC name using the input window that opens when the control window cursor is moved to line 2, then that name becomes the search spec and the group of filespecs attached to the FILESPEC name are not used. That is the original DISKLIST filespec mode and is left in for the old timers who probably won't read about the new features. This feature may also be used to skip matching filespecs. To designate a filespec for files you do not want listed, enter an equal sign immediately after the filespec: i.e. *.bak= or auto=. DISKLIST will convert the equal sign to a three lined equal sign and display it at the end of the filespec. This skip filespec can go in any position in the list of filespecs. DISKLIST first selects all file names that fit the filespecs then eliminates those that meet the skip filespec criteria. If the first filespec you enter after creating a FILESPEC name is a skip filespec, DISKLIST will not delete the default *.*, after all some filespecs have to be selected if any are to be skipped. If you entered only these two filespecs, *.wk? and *.wk*=, then no files would be listed. At least one filespec must select some filenames if any are to be listed. All of the filespec data are saved when you exit DISKLIST. CHANGE SHADE DENSITY DISKLIST can print a background shade on lists printed on laser printers with PCL5. This option works with Output Device selections for Laser Printer, Avery-Laser, Multiple Laser, Sleeve on LJ3, and Sleeve on LJ4. It works on lists with borders and label lists, but it does not function on page format lists. In the upper right hand corner of the control window is the indicator for the selection of this option. Toggle it on and off by pressing A. The list is divided into three areas for shade: the top description block, the file list block in the middle, and the -22- bottom information block. The shade density can be selected for each of these blocks from selection C on the configuration menu. You may enter any number from 0 to 100. 0 is no shade. The laser printer has 10 different densities of shade and it converts your value to one of these. The initial default values for the three blocks are 15, 5, 15. Try 5, 0, 5. Copy the file DISKLIST.LSR into the directory that DISKLIST.EXE is in. DISKLIST.LSR has changes that are important to the shading feature. The left margin on the laser printer is now set with the PCL5 command ESC &l#U (that's a lower case L) instead of ESC &a#L used in DISKLIST versions before 3.0 (replace # with a numeric value). If you are upgrading DISKLIST, copy the new DISKLIST.LSR over the old file, but save it in another directory first. The new laser commands may not work on all laser printers so you may have use the old copy. CUSTOM MULTIPLE LIST LAYOUT (F8) This section explains how to print more than one list on a single sheet. Only laser printers allow printing of lists side by side because DISKLIST prints one complete list then goes back up the page to print the next. Dot matrix and ink jet printers do not permit DISKLIST to move back toward the top of a page to print a list to the right of a list already printed. DISKLIST can do that on laser printers because nothing is put on the paper by the laser printer until the page is ejected. For multiple lists per page on dot matrix printers just print one list after the other down the sheet. When you expect that there is not enough room on the sheet for another list, eject the page with the E command from the control window. For ink jet printers, press FK 6 to access the Laser Setup Window. Then remove the ESC E from the symbol and reset commands. When you expect that there is not enough room for another list, use Control E or ALT E to eject the page. Use the F9 command to save this change because laser setup data is not saved when DISKLIST ends. You can always restore the default laser commands for a specific format with the F6 command. There are two ways to select where to print a list using the Multiple Laser output device, either by using the preset layout or a custom layout. The preset layout is built in DISKLIST. You create the custom layout if you want to. Both operate similar to the Avery Label selection routine. -23- Select 'Multiple Laser' for the Output Device (Parameter 5 in the Control Window). When you press P to print the list the following screen will appear for you to choose the custom or preset layout: Multiple List Layout for format 5¼ 1 with All To use the DISKLIST Preset layout, Enter P Or press RETURN to use your Custom layout. Select (Q = Quit) [Custom]? If you do not have a custom layout for the selected format this screen will appear: Multiple List Layout for format 5¼ 1 with All If you had set up a custom layout for this format it would be available here. (Press F8 from main window to create a custom layout), Your only option now is the Preset list layout, Press any key to continue or Q to Quit? If you have not created a custom layout for the selected format, you will be reminded that you can. You may create a separate custom layout for every format except page formats. To create a custom layout, select item D - Custom Multiple List Layout from the configuration menu or press F8 from the control window. When the preset layout is selected, it presents a matrix of 18 squares, 3 across and 6 down. These just give you an approximate target where to print the list. Choosing a square in the first column causes the list to print against the left margin of the paper, the second column prints a list centered across the page, and the right column prints the list against the right margin of the paper. To print two 5.25 size lists on a page you might try selecting locations 1 and 10. You can also print a 5.25 size on the left side of the sheet and a 3.5 size on the right side. The following is the preset list layout. -24- Multiple List Layout for format 5¼ 1 with All Left Center Right ┌─────────┬─────────┬─────────┐ │ 1 │ 2 │ 3 │ Select a position to ├─────────┼─────────┼─────────┤ use (ESC to Quit) [1]? │ 4 │ 5 │ 6 │ ├─────────┼─────────┼─────────┤ Enter a negative value to mark │ 7 │ 8 │ 9 │ a position as used. ├─────────┼─────────┼─────────┤ │ 10 │ 11 │ 12 │ ├─────────┼─────────┼─────────┤ │ 13 │ 14 │ 15 │ ├─────────┼─────────┼─────────┤ │ 16 │ 17 │ 18 │ └─────────┴─────────┴─────────┘ The Custom Multiple List Layout routine lets you define the coordinates, row and column, for the top left corner of the list. It allows up to 2 columns and 6 rows of lists. However, you may only want to define two locations per page for 5.25 formats and four locations for 3.5 formats. When this routine starts, it prompts for the number of columns of lists you want, 1 or 2, then the number of rows, 1 to 6. It then asks for the position of the top row and left margin (page column) of each location. It provides defaults for each question using what it thinks you might want to use on an initial pass or the value you entered before when making changes. Here is an example of the Custom Multiple List Layout screen after values have been entered: CUSTOM MULTIPLE LIST LAYOUT The list format selected is 3½ 1 with All The current custom positions are: Column 1 Column 2 Row Sheet Column Row Sheet Column 1 0 1 50 30 0 30 50 Do you want to change this (Y/N) [N]? Select the custom location to print the list from the graphic DISKLIST displays. In each box of the graphic are two lines of numbers. The number in the first line identifies the box number. Use this number to select the location to print in. The second line has your custom coordinates for where that list will start on the page. You do not have to print in the locations in order, nor do you have to print in every location. If you do not want to fill a page, eject the page with the E command from the -25- control window. The following is an example of a graphic custom display using data from the above layout screen. Custom Multiple List Layout for format 3½ 1 with All ┌──────────────┬──────────────┐ │ 1 │ 2 │ │ 1 0 │ 1 50 │ ├──────────────┼──────────────┤ Select a Position to │ 3 │ 4 │ use (ESC to Quit) [1]? │ 30 0 │ 30 50 │ └──────────────┴──────────────┘ Enter a negative value to mark Row, Column a position as used. DISK CATALOG DISKLIST can produce a single catalog file of the files that are on many disks. The purpose is for you to be able to search a list to determine which disk a particular file is on. It is intended to be used for disks that contain data files. First check to make sure each disk has a label name. Use the DOS command DIR or LABEL to display the label name. If you want to add or change a label, use the DOS command LABEL. LABEL A: If you don't want to delete or change the existing label, press return when DOS prompts for a new label or none. DOS will then ask if you want to delete the existing label. The label name can be 11 characters and have imbedded spaces. Don't use a period like you do in a file name or DOS will say the name is invalid. Also mark the label name on the disk with a felt tip pen so you can identify the disk later. Run DISKLIST to create the catalog file. For Parameter 5 in the control window, Output Device, select Disk & Vol Name. This feature is similar to the output device File with two exceptions. Only file names, space, date, and time are written to the file, not any titles or directory names. The disk volume label name is written on each line before the file name and the subdirectory name is written on each line after the time data. To make use of this feature, run DISKLIST on a series of disks and send the output to the same catalog file. DISKLIST will append data to a previously used catalog file. You can add a comment about each file name in the catalog file that DISKLIST produced. Use an ASCII word processor such as the DOS EDIT. Start the comment after the file time data and a -26- space. Then sort the file on the file name with the DOS SORT command using the following syntax: SORT /+15 < input file name > output file name The symbols < and > are part of the command and you must put them in. The input file name is the file DISKLIST wrote the data to. The output file can have the same name or any other name. For example, if your catalog file is named CATFILE, then the sort command would be: SORT /+15 < CATFILE > CATFILE You can sort on the subdirectory names or the comments you inserted with the command: SORT /+58 < input file name > output file name The switches /+15 and /+58 specify the column that SORT starts sorting on. To find out more about SORT use the command: SORT /? Now you can print the catalog file to visually scan to find out what disk a particular file is on, or search the catalog file using a word processor or text viewer like the Shareware program LIST. SUBDIRECTORY LIST DISKLIST can limit the list to the files in a single directory or directory tree. Parameter 4 defines the directory you want to list. If the directory name is longer than the display area, the name is truncated for the control window display but the full name is used. On the same line as Directory on the command side of the control window is the command B to toggle Yes or No your desire to also list the subdirectories of the directory you selected. INK JET PRINTER The Hewlett Packard DeskJet, an ink jet printer, has commands similar to the HP LaserJet. Select Ink Jet Printer for the Output Device in the control window. For compressed print, the DeskJet, without a font cartridge, always prints 6 point characters. Compressed print on laser and dot matrix printers is 8.5 point. The effect of this is that the vertical lines did not connect to form a contiguous frame like it -27- does in the normal 10 cpi mode. You may make the compressed lines print closer together by using the laser command editor (F6) to change the Lines per inch command from ESC &l8D to ESC &l12D. This changed the lines per inch from 8 to 12. This may also be necessary on the LJ 4. The Output Device Avery-Laser doesn't work properly on an ink jet printer because, unlike a laser printer where the paper doesn't move until a page is ejected, the ink jet printer moves the paper when printing the first label, and can't backup to begin printing the second. You may still use the Avery-Laser feature by printing one column of labels only. AVERY LASER LABELS DISKLIST prints on Avery laser labels #5196 and #5197. You can select exactly which label to print on, and how many copies to make. If you want to make more copies than will fit on a sheet, DISKLIST will eject a full sheet and continue on the next. You can also tell DISKLIST what label positions on the Avery sheet to not print on. Once DISKLIST prints on a label or you mark it to be skipped, DISKLIST remembers for that sheet. You can print the labels for 9 disks on the sheet for 3.5 inch disks and 12 on the sheet for 5.25 inch disks. Remember to press E when you want to eject a partial page rather than the page eject button on the laser printer so that DISKLIST knows it will be starting on a fresh sheet. When you select a different output device, other than File or Screen, after you printed on the Avery-Laser output device, then press P to print, DISKLIST will automatically eject the sheet in the laser printer, provided you haven't switched the printer port. All of the laser commands to locate and print on Avery labels are imbedded in the program. They are standard HP PCL5 commands and should work on any laser printer that emulates the HP PCL5 commands. Not all label formats will fit on these labels, so DISKLIST indicates the types that do as 'Label - AVERY' under Type at the bottom of the control window screen. Select 'Avery-Laser' for the Output Device (Parameter 5 in the Control Window). Select a Format that supports Avery labels. This information is displayed at the lower right corner of the control window screen under Type. If this information is not displayed, press control L. The type needed is Label - AVERY. When you press P to print the label, one of the following screens will appear depending on the disk label size: -28- AVERY Label Sheet # 5196 ┌─────────┬─────────┬─────────┐ │ │ │ │ │ │ │ │ │ 1 │ 2 │ 3 │ Select a Label Position to │ │ │ │ use (ESC to Exit) [1]? │ │ │ │ ├─────────┼─────────┼─────────┤ Enter a negative value to mark │ │ │ │ a position as used. │ │ │ │ │ 4 │ 5 │ 6 │ │ │ │ │ │ │ │ │ ├─────────┼─────────┼─────────┤ │ │ │ │ │ │ │ │ │ 7 │ 8 │ 9 │ │ │ │ │ │ │ │ │ └─────────┴─────────┴─────────┘ AVERY Label Sheet # 5197 ┌──────────────┬──────────────┐ │ 1 │ 2 │ │ │ │ ├──────────────┼──────────────┤ Select a Label Position to │ 3 │ 4 │ use (ESC to Exit) [1]? │ │ │ ├──────────────┼──────────────┤ Enter a negative value to mark │ 5 │ 6 │ a position as used. │ │ │ ├──────────────┼──────────────┤ │ 7 │ 8 │ │ │ │ ├──────────────┼──────────────┤ │ 9 │ 10 │ │ │ │ ├──────────────┼──────────────┤ │ 11 │ 12 │ │ │ │ └──────────────┴──────────────┘ If you want to prevent printing in a specific position on a sheet, enter the position number as a negative value. If you want to block out label position 4, enter -4. DISKLIST fills used cells on the screen to indicate labels that are not available. After selecting a position to print, you will be asked how many copies. If you have already printed one label and it was cell 3, -29- and you select to print the next label in cell 4, and then you request 4 copies, DISKLIST will print the four copies in cells 4, 5, 6, 7. PRINT ON DISK SLEEVES DISKLIST will print lists and label formats, both 3.5 and 5.25 sizes, on the sleeve of 5.25 inch diskettes. However, this works ONLY ON PRINTERS WITH PCL5 and ONLY ON PLAIN PAPER SLEEVES, NOT TYVEK. PCL5 is standard on HP Laser Jet since series III and available on many other brands. The reason it only works with PCL5 is because DISKLIST uses a PCL5 command that causes the laser to print upside down. The reason for this will become evident in the next paragraph. Do not use Tyvek sleeves because they may melt in the printer. Because of the short length of the sleeve, you must use the following procedure to ensure that the sleeve will travel through the printer. Cut a piece of 8.5 x 11 inch paper in half (two 8.5 x 5.5 pieces). Insert one piece into a plain paper diskette sleeve. Push it all the way to the bottom of the sleeve. Using the single sheet feeder, feed the sleeve and sheet into the laser printer, with the bottom of the sleeve going in first. The printer feeder mechanism will push the sleeve through the printer by pushing on the sheet of paper. Select 'Sleeve on LJ 3' or 'Sleeve on LJ 4' for the Output Device (Parameter 5 in the Control Window). Select any format. If the format is too wide to fit on the sleeve, DISKLIST will tell you when you press P to print. All of the laser commands to print on the sleeve are embedded in the program. If there are more lines to print than will fit on a sleeve, the list will terminate at the end of the page. The difference between output device selections LJ 3 and LJ 4 is that the LJ 3 feeds the sleeve in the center of the printer and the LJ 4 feeds it on the left side. Select LJ 3 or LJ 4 depending whether the paper travels through the center or left side of the printer. MULTIPLE LINES OF TEXT In addition to the one line title, DISKLIST now allows a multiple line message to be printed at the top of the list. It is printed below the title and disk volume name, although both of these can be deselected from the configuration screen. Put your message in an ASCII file. Name that file DISKLIST.HDR. If DISKLIST.HDR is in the root directory of the selected disk, DISKLIST will print it as is, whereas DISKLIST centers the title on the list. Actually it is possible to use DISKLIST to just -30- print this message by deselecting everything else. Laser commands can be put in this file to change font, point size, etc. PAGE TAB VALUE The Page format has built in tabs for the first column of each format. You may want to change them. Create a text file called DISKLIST.TAB. Enter the tabs you want for each of the seven page formats separated by commas. The default tabs starting with format Page 1 with All and ending with Page 6 Across are: 19, 22, 8, 23, 10, 30, 22. If the file DISKLIST.TAB is in the same directory as DISKLIST.EXE then DISKLIST will read it and use these values. Otherwise it skips it and uses the above default values. TEXT INPUT There are several prompts where DISKLIST asks for text input. All follow these rules. DISKLIST always presents the previous data in that field for you to edit if you wish. ESC will erase the entire line. All standard editing features of the computer are available: insert, delete, home, end, left and right arrows. DISKLIST has a novel feature. If you want to enter more characters than will fit into the input window, then DISKLIST scrolls the text sideways. All data will not be displayed in the text window, but it will be used. One exception is the filespec input. It will truncate any input to eight characters before the period and three after the period to comply with DOS standards. When a title for a disk is entered, it will be displayed at the bottom of the control window as illustrated by the text in the control window display above, "The List Title is Displayed Here". To reuse the title, save it with the S command. DISKLIST will save it on the disk drive selected by parameter 1 on the control window. Retrieve it the next time with the R command. Press RETURN or the up or down arrow when you are finished with a text input. STATUS MESSAGES Status messages are displayed in a pop up window. In some cases, such as error messages, you are prompted to press any key to continue. In other cases, such as completion messages, they are displayed for a few seconds then go away. You do not have to wait for these latter messages to go away before entering a command. -31- When you are producing a list, DISKLIST will display the path and file names as it prints them in a status window. Sometimes this goes too fast to read, but the purpose is to let you know that something is happening. DISKLIST will STOP PROCESSING a list IF ANY KEY IS PRESSED and beeps to alert you that it stopped prematurely. When you accidentally start to print the directory of your hard drive, press any key to stop. DISKLIST requires 312 K of free memory and DOS 3.1 or later. MONOCHROME MONITOR The highlight of the selected parameter in the Control Window and the Format Selection Window may not be visible on monochrome monitors. To make it possible for such users to know which parameter is selected, press M to toggle the display of arrows before the item on and off. SUMMARY OF NON-DISPLAYED COMMANDS. M Toggles display arrows for monochrome monitors. D Writes the parameter save file, DISKLIST.PRM V Toggles display of the version number on line 25. ^B Toggles the blind command action beeper on/off. ^L Toggles display of Format data at bottom of screen. ^E Sends the laser printer reset command ESC E. ^R Sends the laser printer reset command ESC E. ^H Toggles display of 'Parameters' and 'Commands' in the top line of the control window. ^ means hold the Control Key down, then press the letter. You may use the ALT key instead of the Control Key for these four keys. BATCH OPERATION DISKLIST can be run from the command line or a batch file without any display. It will print one list then exit. Only /AUTO is required. The format of the command line is: -32- DISKLIST drive /AUTO, filespec, directory, list subdirectories?, type sort, sort direction, output device, format, printer port, read title from disk drive the drive letter of the diskette to be read, optional /AUTO tells DISKLIST to perform an automatic operation filespec file selection template, i.e. *.* directory directory name list subdirectories? 0 = Yes, 1 = No Type Sort Enter a digit for the type sort desired: 1 = Name, 2 = .EXT, 3 = Date, 4 = Size, 5 = No sort Sort Direction 0 = Ascending, 1 = Descending Output Device 0 = NonLaser printer, 1 = Screen, 2 = Disk, 3 = Laser Printer, 4 = Avery-Laser 5 = Sleeve on LJ 3, 6 = Catalog file Format 1 to 39 as numbered in DISKLIST with F7 Printer Port Enter LPT #, i.e. 1, 2 or 3. Enter digit only Read Title Y = read, N = not to read, the title for list from DISKLIST.TTL on the selected drive All of these parameters are optional except /AUTO. DISKLIST will use the parameter values it used last which are saved in the file DISKLIST.PRM unless you override then on the command line. If you do want to override a selection, you must insert all of the commas before the value so DISKLIST knows which parameter you are changing. For example, if the only change for this run to parameters saved in the DISKLIST.PRM file is that you want to sort by size instead of by the selection saved in DISKLIST.PRM, then enter this command: DISKLIST /AUTO,,,,4 The last three of the four commas indicate that you accept the values in DISKLIST.PRM for filespec, directory, and list subdirectories?. And since there are no entries after the 4 (for Size), you also accept all the other parameters in DISKLIST.PRM. DISKLIST.PRM is not changed after a /AUTO run. There is a file on the distribution disk named AUTOLIST.BAT. You can edit it with a text editor to insert the values you desire in the line that starts with DISKLIST. Rem stands for REMARK and tells DOS to ignore that line. The comments on the rem lines are there to help you figure out what parameters to put where. Leave all the rem lines in, and execute the bat file just by entering its name, AUTOLIST, at a DOS prompt. You may also run DISKLIST /? which produces a help screen. The file AUTOLIST.HLP must be in the same directory as DISKLIST.EXE. -33- FILENAMES The names and purpose of all DISKLIST system files are listed below. There are no hidden files. Only the first nine files are distributed with DISKLIST. The next four are created by DISKLIST, and the last three are created by you for special features. DISKLIST.EXE Program DISKLIST.DOC Documentation DISKLIST.LSR HP LaserJet Commands for each format DISKLASR.DOC Additional documentation on LaserJet Commands DISKLIST.ICO DISKLIST Icon for Windows DISKLIST.PIF DISKLIST Program Information File for Windows AUTOLIST.HLP Help file displayed by DISKLIST /? AUTOLIST.BAT Training wheels for a DISKLIST batch file DISKLIST.C Data file for double strike printer codes Change name to DISKLIST.C1 to use DISKLIST.PRM Saved program configuration & nonlaser printer control codes DISKLIST.TTL Disk title DISKLIST.TXT Default file name for a list output to a disk DLCUSTOM.DTA Custom multiple list layout data DISKLIST.FNT File containing names of your soft fonts DISKLIST.TAB Optional tab values for page formats DISKLIST.HDR Multiple line text file to print on label -34- DISKFLAP Lists for 5.25 inch disks can be kept in the disk sleeve. Some 3.5 inch disks have clear plastic sleeves which are nifty for holding the DISKLIST list. DISKLIST lists can be attached to a 3.5 inch disk in a way that allows them to remain attached to the diskette when it is inserted into most floppy drives. The list can even be read when the diskette is in a horizontal drive. This is accomplished by tapping the list to the back of the diskette with one small piece of tape placed along the edge of the diskette that doesn't go into the drive. You then have a list that stays attached to the diskette even when it is inserted in the drive. Edge of disk that does not go into drive _______=====________ _ <-----Masking Tape Hinge | | | |\ | [] | | | \ | | | | \ | | | | \<------ List printed | 0 | | | \ by DISKLIST | | | | \ Printed side | Front of | | | \ out | 3.5 " disk | | | \ | | | | \ \___________________| |_| Front View Side View The tape only has to be 3/4 to 1 inch by 1/2 inch. When you cut the list out, leave about 1/4 inch of paper above the printed frame of the list. Place the list on the back of the disk with the top edge of the list along the back edge of the disk, printed side out. Tape the list to the disk. The tape acts as a hinge so the list can fold against the disk for storage, or fold straight out away from the disk when the disk is inserted into the drive. Masking tape works best and the list can be pulled from the tape to be replaced. Scotch tape also works. -35- INSTALL THE DISKLIST ICON This section is a step by step instruction on installing the DISKLIST icon in a Windows 3.1 Group. If anything goes wrong, just start over. Copy the files DISKLIST.ICO and DISKLIST.PIF to your Windows directory. Most likely it is C:\WINDOWS. The PIF Editor Go to the Windows Program Manager window. Activate the Main Group. Find the PIF editor icon. It looks like a yellow paper tag. Double click on the PIF editor icon. Click on File in the PIF editor window, then click on Open. Click on DISKLIST.PIF in the filenames list, then click on OK. Check the path in the Program Filename box. Change it if necessary to indicate where DISKLIST.EXE is located on your computer. If you changed the data in this box click on File, then click on Save. Click on File again then click on Exit. Installing the DISKLIST icon. Click on the title bar of the Windows Group where you want to place the DISKLIST icon. Click on File in the Program Manager window, then click on New. The New Program Object box will appear. There should be a dot in the circle before Program Item; if not click there. Then click OK. In the Program Item Properties window, Enter DISKLIST for Description. Tab to Command Line and enter DISKLIST.PIF. Click on Change Icon. The Change Icon box will appear and tell you There are no icons available for the specified file. Click on OK. The Change Icon window will open with the name C:\WINDOWS\PROGMAN.EXE in the File Name box. Change the name from PROGMAN.EXE (or whatever file name is there) to DISKLIST.ICO. Click OK and the DISKLIST icon will appear. Click OK. Back in the Program Item Properties window you will see the DISKLIST icon. Click OK and you are done. The DISKLIST icon will be the last icon in the Windows Group you selected above. Just double click on it whenever you want to run DISKLIST. -36- SHAREWARE DISKLIST is NOT a public domain program. It is copyrighted and distributed as Shareware. DISKLIST may be distributed on bulletin boards, by computer user groups and by disk vendors. All of the files listed in the file PACKING.LST must be distributed together and unaltered. If, after evaluating DISKLIST, you decide to use it or keep it for when you will need it, then you MUST submit the registration fee. The registration form must be printed from DISKLIST with the F command. When you register DISKLIST you will receive: Telephone and mail support. A copy of the latest version of DISKLIST Removal of the Shareware Screen and reminders. Skip the Help screen at start of the program. Skip the registration form reminder at the end of the program. A loan amortization program with both the BASIC source code and the compiled program. No registration is required for the amortization program. A Copy of SHERLOCK for you to try before registering. A free introductory membership certificate to CompuServe with a $15.00 credit towards online time. Your registered copy of DISKLIST will NOT display the initial Shareware title screen, the registration reminders, or the initial or laser command setup help screens. DISKLIST will be delivered on a 3.5 inch 1.44 meg floppy. If you cannot use this size, please indicate on the registration form the size of the floppy disks that you can use. The registration fee is $25.00 plus $4.00 shipping & handling. Maryland residents add 5% state sales tax ($1.25). All checks and money orders must be in US funds and drawn on a US bank. Visa, MasterCard or American Express may be used. Most copies of software on bulletin boards and even in software vendor libraries are not the latest version. It takes a long time for these to get around, and most of the effort is placed on the widest distribution of the initial release. And with so much emphases being placed on 'safe software' these days, where is there a more reliable place to obtain your software than directly from an author member of the Association of Shareware Professionals. -37- Once in a while DISKLIST will act like it is registered for non registered users. It starts running without the shareware screen and displays a window with the message 'Will Run as if REGISTERED' just to show you how it will run when registered. MULTICOPY FEES The following is the schedule of the multicopy license fees. The fee includes one master diskette which you may then copy and use on the number of computers listed below: # Users Price ------- ------- 5 $ 100.00 ($20 per copy) 10 140.00 ($19 per copy) 25 425.00 ($17 per copy) 50 750.00 ($15 per copy) 100 1,200.00 ($12 per copy) Site 2,500.00 For corporate, educational institution, and network discounts, contact Gulf Sierra. EPILOGUE Please report discrepancies (bugs) that you find in DISKLIST. Include the version number and sufficient information for me to replicate the incident. When I correct a bug, the person who reported it gets the first copy. Whenever you write, please include your home phone number. You can also send CompuServe mail to me. My CompuServe ID is 73270,77. You may send mail to me at Compuserve from Internet using the Internet Address 73270.77@compuserve.com. That is a period instead of a comma in 73270.77@compuserve.com and use lower case. I usually answer questions by phone on the weekend or early in the evening Eastern time. If you do not like DISKLIST, please let me know that you tried it and, if you wish, why you will not use it again. Tell me what features would have made DISKLIST useful to you. Perhaps you had a problem because I didn't clearly convey how to use it. Many features in my software were suggested by people who did not register. And of course, many more were suggested by those who did. You may use the registration form to reply and cross out the word Registration. -38- COMMERCIAL LABELS Avery produces stick on labels for both form fed printers and laser printers. These labels are available from many office supply stores and catalogs. The Avery disk labels are: Catalog Label Size Number For 3.5" disks and form fed printers 2.75 x 2.75 4241 For 5.25" disks and form fed printers 1.25 x 4.75 4240 For 3.5" disks and laser printers 2.75 x 2.75 5196 For 5.25" disks and laser printers 1.50 x 4.00 5197 These labels can be purchased in many local computer and office supply stores. Here is one catalog company that advertises these Avery labels. I have not purchased from them and am not in any way connected with them. They had the numbers in a convenient way in the catalog that made it easy for me to find. DARTEK Computer Supply Corporation 949 Larch Avenue Elmhurst, IL 60126 Phone 800-832-7838 also 708-832-2100 FAX 708-941-1106 They take VISA, MasterCard, American Express, and Discover and have a catalog. Avery # Dartek # Quantity Price in 1993 4241 34296 250 $14.49 4240 34294 250 $12.95 5196 57825 540 $31.00 5197 57828 840 $31.00 Minimum order is $25. On orders less than that they include a handling charge, but the catalog doesn't say how much. Shipping appears to be included although FedEx is available at an extra charge. OMBUDSMAN This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the Shareware principle works for you. If you are unable to resolve a Shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. -39- The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427, FAX 616-788-2765 or send a CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536. -40- IBM GRAPHICS EXAMPLE This is an example of another format for the DISKLIST output. It can be seen on the computer screen and printed on a printer setup for IBM graphics. If this figure is not framed in continuous lines, then your printer is not setup for IBM graphics. Read your printer manual to determine if it is possible to switch to that mode. Otherwise, you can still use DISKLIST with the ASCII character frame as illustrated on page 1. ┌────────────────────────────────────────────────┐ │ GREAT SHAREWARE │ │ Volume ID is DISKLIST │ │ 1,457,664 Total Space 893,440 Bytes Free │ ├────────────────────────────────────────────────┤ │ A:\ 153,664 BYTES │ │ DISKLIST.DOC 34,377 08/15/90 19:32:16 │ │ DISKLIST.EXE 119,144 08/14/90 22:02:18 │ │ DISKLIST.PRM 124 03/25/90 11:11:48 │ │ DISKLIST.TTL 19 03/25/90 11:05:06 │ │ │ │ A:\PC-ACCOU.NT 230,862 BYTES │ │ PCACT220.EXE 156,150 11/08/89 19:03:52 │ │ PCACT220.TXT 6,838 11/09/89 18:30:42 │ │ PCDOC220.EXE 67,874 11/08/89 19:09:22 │ │ │ │ A:\SHERLOCK 175,967 BYTES │ │ SHERLOCK.DOC 30,895 08/15/90 19:35:14 │ │ SHERLOCK.EXE 145,072 08/15/90 19:44:04 │ ├────────────────────────────────────────────────┤ │ 9 Files 08-17-1990 18:46:20 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ Created by DISKLIST │ └────────────────────────────────────────────────┘ This is shown in the 5.25 inch normal format. DISKLIST can also print in 38 other formats. -41-